Asistente para adaptar DB2 de Approach a Web

Bienvenido al Asistente para adaptar DB2 de Approach a Web.
Con este Asistente podr trasladar a Web sus aplicaciones de
Approach/DB2 o adaptarlas para Web, utilizando la tecnologa
DB2WWW de IBM.

* Qu es el Asistente para adaptar DB2 de Approach a Web?
* Requisitos de software
* Utilizacin del Asistente para adaptar DB2 de Approach a Web
* Limitaciones


Qu es el Asistente para adaptar DB2 de Approach a Web?
Asistente para adaptar DB2 de Approach a Web permite crear
aplicaciones para Internet a partir de aplicaciones de
Approach/DB2. Permite elegir una aplicacin de Approach nueva o
existente realizada en un servidor de bases de datos DB2 de IBM
y adaptarla a Web mediante el Asistente para adaptar DB2 de
Approach a Web.

Primero cree visualmente su aplicacin de Approach utilizando un
servidor de bases de datos DB2 de IBM. A continuacin, utilice el
Asistente para adaptar DB2 de Approach a Web para "convertir" la
aplicacin de Approach en una aplicacin IBM DB2WWW o Net.Data.
El Asistente, partiendo de los formularios e informes realizados
en DB2, crear formularios HTML mediante la tecnologa DB2WWW de
IBM o Net.Data. El resultado final ser una aplicacin para
Internet utilizando un servidor para bases de datos DB2 de IBM. 


Requisitos de software
- Lotus Approach 97
- IBM DB2 CAE (nicamente si Approach y DB2 se ejecutan en equipos
diferentes)
- IBM DB2WWW v1 o Net.Data
- Servidor HTTP
- Servidor DB2 de IBM

Utilizacin del Asistente para adaptar DB2 de Approach a Web
Paso 1. Seleccin de la aplicacin de Approach a utilizar para
la consulta.
El Asistente mostrar una lista de todas las aplicaciones
que estn abiertas en Approach. Tambin puede elegir otras
aplicaciones seleccionando "Abrir".

Paso 2. Seleccin del formulario de entrada y del informe de salida.
El Asistente mostrar una lista de todos los formularios e informes
disponibles en la aplicacin seleccionada.

Seleccione un formulario. El formulario se mostrar como un formulario
de consulta HTML.

Seleccione un informe en el que visualizar el resultado de la solicitud.
Si selecciona "Informe como formulario de entrada", el informe de
Approach que seleccione se utilizar tanto para el formulario de consulta
como para el informe resultante.

Haga clic en "Seleccionar fondo para Web" para seleccionar la imagen
a utilizar como fondo para el formulario HTML y el informe HTML.
Nota: Si instala el Asistente para adaptar a Web mediante
la instalacin personalizada, las imgenes se instalarn en una
subcarpeta dentro de la carpeta de Smartmasters de Approach.
Deber mover dichas imgenes hasta la carpeta adecuada del servidor Web.

Si la opcin "Informe como formulario de entrada" est
seleccionada, el informe se utilizar como consulta HTML y como
informe HTML.

Paso 3. Acceso
Para definir un ID de usuario y una contrasea a utilizar por todo
usuario que desee acceder al formulario de entrada HTML y registrarse
en DB2, seleccione "Utilizar siempre" y especifique un ID de usuario
y una contrasea. Si desea que se solicite al usuario su identificacin
o contrasea, seleccione "Solicitar al usuario".

Indique un nombre de base de datos vlido (imprescindible). El
Asistente para adaptar DB2 de Approach a Web no continuar hasta que
lo haya hecho.

Especifique un nombre para el archivo de macros de DB2WWW. El Asistente
crear el archivo en la ubicacin especificada y con el nombre
especificado. 

Paso 4. Opciones de SQL
A continuacin, debe configurar varias opciones de SQL.

Visualizacin SQL
Define si debe mostrarse al usuario la sentencia de SQL que se genera
y se enva a DB2. Seleccione una de las siguientes opciones:

Solicitar al usuario - Pregunta a los usuarios si desean visualizar
la sentencia de SQL en el informe.
Siempre activada - Muestra siempre la sentencia de SQL en el informe.
Siempre desactivada - Nunca muestra la sentencia de SQL en el informe.
Nota: Si dispone de la primera versin de DB2WWW, se ignorar esta
opcin y la sentencia de SQL aparecer siempre. Actualice a la ltima
versin de DB2WWW o Net.Data.

Tipo de bsqueda
Define que tipo de bsqueda que se realizar. Seleccione una de las
siguientes opciones:

Solicitar al usuario - Pregunta a los usuarios el tipo de bsqueda en
el formulario de consulta.
Y - El tipo de bsqueda es siempre Y.
O - El tipo de bsqueda es siempre O.

Definir tabla de mensajes de error/advertencia
Asigna los cdigos de error de SQL que devuelve el servidor DB2
con sus mensajes de error. Los mensajes de esta tabla deben estar en
formato HTML.

Puede utilizar la tabla de mensajes de error/advertencia para que el
archivo de macros generado "busque" los cdigos de SQL devueltos como
resultado de una consulta. Si se produce una advertencia o error de
SQL como resultado de una consulta del usuario, el archivo de macros
generado puede realizar un proceso alternativo. Por ejemplo, puede
especificar sus propios mensajes de error/advertencia en lugar de
utilizar los mensajes predeterminados.

Para agregar su propia correspondencia de mensajes de error/advertencia,
especifique el cdigo de SQL del mensaje de error/advertencia que
desee buscar. Observe que debe especificar el cdigo de SQL y no el
nmero de mensaje de error de SQL. Por ejemplo, para buscar la
condicin "Nombre de usuario y/o contrasea incorrecta", debe especificar
el cdigo de SQL "-1403" y no el nmero del mensaje de error "SQL01403N".
Seguidamente, especifique el mensaje que desea que aparezca cuando se
produzca el cdigo de SQL. El texto del mensaje de error puede incluir
cualquier HTML vlido. Por ltimo, para cdigos de SQL positivos,
dispone de la opcin "Continuar". Si se especifica esta opcin, se
mostrar el resto de la pgina de informe HTML a continuacin del
mensaje. De este modo, si un informe cuenta con un encabezado o un pie
de pgina que desee que aparezca junto con su mensaje de error, marque
la casilla "Continuar". Observe que "Continuar" no es una opcin vlida
para cdigos de SQL negativos. Los cdigos de SQL negativos nunca pueden
"continuar" y, por lo tanto, no se mostrar ninguna parte del informe
HTML.

En la parte inferior de la tabla, tiene la opcin de especificar un
mensaje de error predeterminado. Si se produce un error o una advertencia
que no coincida con ninguna entrada de la tabla de mensajes de
error/advertencia, se utilizar el mensaje de error predeterminado.
En caso de que no se haya especificado ningn mensaje de error
predeterminado, se mostrar un mensaje de error de DB2.

Nmero mximo de filas a devolver
Define el nmero mximo de filas que DB2 devolver para el informe.

Especifique el nmero mximo de filas a devolver de la consulta DB2.
El valor 0 har que se devuelvan todas las filas.

Paso 5. Opciones de WWW
Ruta de las imgenes
La ruta de acceso de las imgenes es la unidad:\carpeta del servidor
HTML en la que estn almacenadas las imgenes.

Especifique la ruta de acceso de la carpeta de imgenes en el servidor
HTML.

Subcarpeta de macros
Esta ruta de acceso se refiere a la subcarpeta situada en la carpeta de
macros de DB2WWW en la que se almacenan los archivos de macros. Esta
informacin es opcional. De forma predeterminada, es la carpeta raz de
macros de DB2WWW. El Asistente no crear el archivo de macros en esta
carpeta a no ser que el usuario especifique una unidad asignada a dicha
carpeta. El usuario debera situar los archivos de macro (*.d2w) en la
carpeta de macros.

Nombre del ejecutable
Es la ruta de acceso y el nombre del archivo ejecutable de DB2WWW
(p.ej. /cgi-bin/DB2WWW.EXE)

Especifique la carpeta en la que se encuentre el archivo ejecutable de
DB2WWW.

Conversin maysc./minsc.:
No convertir -  Se respetar la combinacin de maysculas y minsculas
especificada por el usuario en el formulario de entrada HTML.
Minsculas - Todos los datos especificados por el usuario en el
formulario de entrada HTML se convertirn a minsculas antes de
presentar la consulta.
Maysculas - Todos los datos especificados por el usuario en el
formulario de entrada HTML se convertirn a maysculas antes de
presentar la consulta.

Opciones del formulario:
Enviar - Esta opcin enva el contenido del formulario de consulta
al servidor como cuerpo de un mensaje (mtodo recomendado).
Obtener - Esta opcin adjunta el contenido del formulario de consulta
a la URL.


Limitaciones

Cuadros de texto de Approach con clculos
Los cuadros de texto de Approach que contengan clculos no podrn
convertirse. Los comentarios HTML se agregarn en la posicin donde
debera estar el cuadro de texto calculado.
Los campos calculados son traducidos por el formulario de consulta,
pero no pueden utilizarse.
Las columnas calculadas en los informes quedarn en blanco.

Campos
Utilice los operadores apropiados (>, <, =, etc...) para los campos
que no sean de tipo carcter de las consultas. Por ejemplo, especifique
">10" para un campo de tipo entero. Los campos de tipo carcter deben
consultarse utilizando la sintaxis PARECIDAS '%criterios%', donde "criterios"
representa la cadena incluida en el campo.

Imgenes
Las etiquetas HTML para las imgenes de formularios e informes de
Approach se ubican en el archivo de macros *.D2W. El nombre que se
asigna a la imagen es el mismo que el nombre del objeto, con
extensin .GIF. Para determinar el nombre del objeto de una imagen,
cambie al modo Diseo en la vista que contenga el objeto, seleccinelo
haciendo doble clic en l acceda a la pestaa Macros en el cuadro de
informacin.

Dibujos y objetos miscelneos en encabezados y pies de
pgina del informe
No se admiten en esta versin del Asistente.

Color de fondo del informe
Si se muestra la sentencia de SQL, no se mostrar el color de fondo de
los informes (consulte la opcin Visualizacin SQL). DB2WWW agregar
la citada sentencia de SQL al principio del documento HTML, antes de
la etiqueta del cuerpo, lo cual impedir que se muestre el color.
En su lugar, se mostrar el color predeterminado del navegador.

Alias de tablas
El Asistente para adaptar DB2 de Approach a Web no admite alias de
tablas. Los alias de tablas se utilizan cuando se une una tabla a s
misma. El Asistente admite uniones entre diferentes tablas.
